home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / memory.z / memory
Encoding:
Text File  |  2002-10-03  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmeeeemmmmoooorrrryyyy((((3333CCCC))))                                                          mmmmeeeemmmmoooorrrryyyy((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_eeee_mmmm_oooo_rrrr_yyyy: _mmmm_eeee_mmmm_cccc_cccc_pppp_yyyy, _mmmm_eeee_mmmm_cccc_hhhh_rrrr, _mmmm_eeee_mmmm_cccc_mmmm_pppp, _mmmm_eeee_mmmm_cccc_pppp_yyyy, _mmmm_eeee_mmmm_mmmm_oooo_vvvv_eeee, _mmmm_eeee_mmmm_ssss_eeee_tttt - memory
  10.      operations
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_rrrr_iiii_nnnn_gggg_...._hhhh_>>>>
  14.  
  15.      _vvvv_oooo_iiii_dddd _****_mmmm_eeee_mmmm_cccc_cccc_pppp_yyyy _((((_vvvv_oooo_iiii_dddd _****_ssss_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _vvvv_oooo_iiii_dddd _****_ssss_2222_,,,, _iiii_nnnn_tttt _cccc_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  16.  
  17.      _vvvv_oooo_iiii_dddd _****_mmmm_eeee_mmmm_cccc_hhhh_rrrr _((((_cccc_oooo_nnnn_ssss_tttt _vvvv_oooo_iiii_dddd _****_ssss_,,,, _iiii_nnnn_tttt _cccc_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  18.  
  19.      _iiii_nnnn_tttt _mmmm_eeee_mmmm_cccc_mmmm_pppp _((((_cccc_oooo_nnnn_ssss_tttt _vvvv_oooo_iiii_dddd _****_ssss_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _vvvv_oooo_iiii_dddd _****_ssss_2222_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  20.  
  21.      _vvvv_oooo_iiii_dddd _****_mmmm_eeee_mmmm_cccc_pppp_yyyy _((((_vvvv_oooo_iiii_dddd _****_ssss_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _vvvv_oooo_iiii_dddd _****_ssss_2222_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  22.  
  23.      _vvvv_oooo_iiii_dddd _****_mmmm_eeee_mmmm_mmmm_oooo_vvvv_eeee _((((_vvvv_oooo_iiii_dddd _****_ssss_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _vvvv_oooo_iiii_dddd _****_ssss_2222_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  24.  
  25.      _vvvv_oooo_iiii_dddd _****_mmmm_eeee_mmmm_ssss_eeee_tttt _((((_vvvv_oooo_iiii_dddd _****_ssss_,,,, _iiii_nnnn_tttt _cccc_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      These functions operate as efficiently as possible on memory areas
  29.      (arrays of bytes bounded by a count, not terminated by a null character).
  30.      They do not check for the overflow of any receiving memory area.
  31.  
  32.      _mmmm_eeee_mmmm_cccc_cccc_pppp_yyyy copies bytes from memory area _s_2 into _s_1, stopping after the
  33.      first occurrence of _c (converted to an _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr) has been copied, or
  34.      after _n bytes have been copied, whichever comes first.  It returns a
  35.      pointer to the byte after the copy of _c in _s_1, or a null pointer if _c was
  36.      not found in the first _n bytes of _s_2.
  37.  
  38.      _mmmm_eeee_mmmm_cccc_hhhh_rrrr returns a pointer to the first occurrence of _c (converted to an
  39.      _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr) in the first _n bytes (each interpreted as an _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd
  40.      _cccc_hhhh_aaaa_rrrr) of memory area _s, or a null pointer if _c does not occur.
  41.  
  42.      _mmmm_eeee_mmmm_cccc_mmmm_pppp compares its arguments, looking at the first _n bytes (each
  43.      interpreted as an _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr), and returns an integer less than, equal
  44.      to, or greater than 0, according as _s_1 is lexicographically less than,
  45.      equal to, or greater than _s_2 when taken to be unsigned characters.
  46.  
  47.      _mmmm_eeee_mmmm_cccc_pppp_yyyy copies _n bytes from memory area _s_2 to _s_1.  It returns _s_1.
  48.  
  49.      _mmmm_eeee_mmmm_mmmm_oooo_vvvv_eeee copies _n bytes from memory areas _s_2 to _s_1.  Copying between
  50.      objects that overlap will take place correctly.  It returns _s_1.
  51.  
  52.      _mmmm_eeee_mmmm_ssss_eeee_tttt sets the first _n bytes in memory area _s to the value of _c
  53.      (converted to an _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr).  It returns _s.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      _ssss_tttt_rrrr_iiii_nnnn_gggg(3C).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmeeeemmmmoooorrrryyyy((((3333CCCC))))                                                          mmmmeeeemmmmoooorrrryyyy((((3333CCCC))))
  71.  
  72.  
  73.  
  74. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  75.      For maximum portability, _m_e_m_m_o_v_e should be used when the memory areas
  76.      indicated by ssss1111 and ssss2222 may overlap, and _m_e_m_c_p_y used for faster copying
  77.      between non-overlapping areas.  In this implementation, however, _m_e_m_c_p_y
  78.      is an efficient copying algorithm which correctly handles overlapping
  79.      areas.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.